Skip to main content

Ban System

Table of Contents​

What is the Ban System?​

The Ban System is a tool for server administrators to manage player access by banning players from the server. It allows for both permanent and temporary bans, custom reasons, and keeps a record of all ban actions.

How to Access the Ban System Menu​

To access the Ban System Menu, open the admin panel and locate "Ban System".

Ban System Menu Options​

Once you open the Ban System Menu, you will see several options:

  • Ban a Player: Apply a new ban to a player.
  • Unban a Player: Remove an existing ban on a player.
  • List All Bans: View a list of all currently active and expired bans.
  • System Settings: Configure various aspects of how the ban system operates.

Ban a Player​

This option allows you to ban a player from the server.

  1. Select Player: Choose an online player from the list.
  2. Ban Type:
    • Permanent: The player is banned indefinitely until manually unbanned.
    • Temporary: The player is banned for a specific duration. If you choose this, you'll be asked to set the duration in days, hours, and minutes.
  3. Reason for Ban: Provide a reason for the ban. This will be shown to the player when they attempt to join.

After confirming, the player will be kicked from the server and banned according to your settings.

Unban a Player​

This option allows you to remove a ban from a player.

  1. Select Player: Choose a player from the list of currently banned players.
  2. Confirmation: You will be asked to confirm if you want to unban the selected player.

Upon confirmation, the player will be unbanned and able to join the server again.

List All Bans​

This option displays a comprehensive list of all bans, both active and expired.

  • For each ban, you'll see:
    • The player's username.
    • The reason for the ban.
    • Who banned them.
    • The date the ban was issued.
    • The unban date (if temporary) or "Permanent".
    • The remaining time on the ban (if temporary and active).

System Settings​

This section allows you to customize how the Ban System functions.

  • Kick Message: Customize the message a banned player sees when they try to join the server. You can use placeholders like {reason}, {bannedBy}, {banDate}, and {unbanDate}.
  • Check Interval (Seconds): How often the system checks for expired bans and enforces active bans. A lower number means more frequent checks.
  • Log Ban History: If enabled, all ban and unban actions will be recorded in the server's logs.
  • Broadcast Bans: If enabled, a message will be sent to all online players when someone is banned.
  • Broadcast Unbans: If enabled, a message will be sent to all online players when someone is unbanned.

Important Notes​

Permanent vs. Temporary Bans​

  • Permanent bans remain active until an administrator manually unbans the player.
  • Temporary bans automatically expire after the set duration.

Ban History​

The system keeps a record of all bans, even after they expire or are unbanned. This allows you to review past actions.

Player Kicks​

When a player is banned, they are immediately kicked from the server.

Offline Players​

You can typically only ban players who are currently online. If a player is offline, you might need to use their exact username. For unbanning, you can unban players whether they are online or offline, as long as they are on the ban list.